docs: add X/Twitter source packet workflow - #2

Summary

• document a reviewed source-packet mode for public X/Twitter Markdown inputs
• add @xquik/tweetclaw as an optional OpenClaw-compatible packet source
• keep packet mode separate from authenticated fetches and browser login
• reject lookalike and unrelated hosts before any authenticated tweet fetch

Independent Repository Fix

• restrict tweet URL parsing to supported x.com and twitter.com hostnames
• add focused tests for valid URLs, bare IDs, and lookalike-domain rejection

Packet Contract Improvements

• separate required packet fields from optional metadata
• preserve source packet field names in generated front matter
• document the provider fallback and omit absent optional fields

Validation

• bun test baoyu-danger-x-to-markdown/scripts/tweet-to-markdown.test.ts (3 tests, 8 assertions)
• bun build baoyu-danger-x-to-markdown/scripts/tweet-to-markdown.ts --target=bun
• git diff --check
• public hygiene and credential-pattern scans
• live GitHub and npm source checks for @xquik/tweetclaw 1.6.37

Xquik is an independent third-party service. Not affiliated with X Corp. "Twitter" and "X" are trademarks of X Corp.